home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / ifl / iflListItem.z / iflListItem
Encoding:
Text File  |  1998-10-20  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. iiiiffffllllLLLLiiiissssttttIIIItttteeeemmmm((((3333))))    IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiiffffllllLLLLiiiissssttttIIIItttteeeemmmm((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiiffffllllLLLLiiiissssttttIIIItttteeeemmmm - an element of an doubly linked list (iflList or
  10.      iflMultiList)
  11.  
  12. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  13.      This is a base class.
  14.  
  15. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  16.      #include <ifl/iflList.h>
  17.  
  18. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      iflListItem is a base class from which to derive elements to be placed in
  20.      either an iflList or an iflMultiList.
  21.  
  22.    UUUUssssiiiinnnngggg iiiiffffllllLLLLiiiissssttttIIIItttteeeemmmm
  23.      To make a list of integers, for example, define a derivation of
  24.      iflListItem to hold the integer:
  25.  
  26.           struct intItem : public iflListItem {
  27.               intItem(int val) { i = val; }
  28.               int i;
  29.           };
  30.  
  31.  
  32.      This class can then be used to build a list of integer values:
  33.  
  34.           iflList<intItem> list;
  35.           for (int i = 0; i < 10; i++)
  36.               list.append(new intItem(i));
  37.  
  38.  
  39. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
  40.    CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr
  41.           iflListItem()
  42.  
  43.  
  44.    IIIInnnniiiittttiiiiaaaalllliiiizzzzaaaattttiiiioooonnnn
  45.           void initLinks()
  46.  
  47.  
  48.    MMMMaaaannnniiiippppuuuullllaaaattttiiiioooonnnn
  49.           void unlink()
  50.  
  51.  
  52.    QQQQuuuueeeerrrryyyy
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiiffffllllLLLLiiiissssttttIIIItttteeeemmmm((((3333))))    IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiiffffllllLLLLiiiissssttttIIIItttteeeemmmm((((3333))))
  71.  
  72.  
  73.  
  74.           int isLinked()
  75.  
  76.  
  77. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  78.      iiiiffffllllLLLLiiiissssttttIIIItttteeeemmmm(((())))
  79.  
  80.           iflListItem()
  81.  
  82.  
  83.           Creates an iflListItem with NULL linkage (not part of any list).
  84.  
  85.      iiiinnnniiiittttLLLLiiiinnnnkkkkssss(((())))
  86.  
  87.           void initLinks()
  88.  
  89.  
  90.           Reset the linkage of this item to NULL.  This is mainly used is
  91.           special initialization cases (like allocation from a shared arena).
  92.  
  93.      iiiissssLLLLiiiinnnnkkkkeeeedddd(((())))
  94.  
  95.           int isLinked()
  96.  
  97.  
  98.           Returns TRUE if this item is currently on a list, FALSE otherwise.
  99.  
  100.      uuuunnnnlllliiiinnnnkkkk(((())))
  101.  
  102.           void unlink()
  103.  
  104.  
  105.           Removes an item from whatever list it is currently linked on to. Bad
  106.           things will happen if you call this method on an item that is
  107.           already unlinked.
  108.  
  109. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  110.      iflList, iflMutliList, iflListIter, iflListIterRev
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.